Skip to main content

5.1.2 创建提款数字币至任意钱包(商户自定义汇率)

#简要描述: 将数字币提现到钱包的提现业务接口,让用户能够将 usdt 转移到指定的钱包地址 (商户可自定义汇率)

创建支付订单

请求参数
参数名称类型必填参数含义参数说明
keystring商户 key平台分配商户 key
localOrderIdstring商户平台订单号商户生成唯一订单号
localUserIdstring平台分配商户商户号
notifyUrlstring回调地址下发成功后,由 API 回调商户的地址(回调详情说明在最下方)
successRedirectUrlstring地址成功后自动跳转地址
currencystring币种币种(钱包支持币种)
networkstring主网主网(目前仅支持 TRON、BSC)
addressstring提款地址提款地址
quoteCurrencystring订单报价币种订单报价币种(需商户登录后台设置报价币种汇率)
quoteAmountstring报价金额报价金额
signstring签名详情见签名算法
请求 json 样例
{
"key": "9yUreYgTRtit39Dy",
"localOrderId": "111122212",
"currency": "USDT",
"network": "TRON",
"address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
"quoteCurrency": "CNY",
"quoteAmount": "10",
"sign": "8236defe6976dcc6798eeacbb43b955c"
}

支付返回 json 格式

返回 data 示例
{
"code": 0,
"success": true,
"message": null,
"data": {
"orderId": 273582559791593,
"localUserId": null,
"localOrderId": "111122212",
"orderType": "WITHDRAW",
"orderBizType": "WITHDRAW_ANY_DIGITAL_WALLET",
"targetType": "EXTERNAL",
"network": "TRON",
"address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS"
}
}
data 参数说明
参数名称类型参数含义备注
codenumber下单状态值下单成功:0
successboolean下单成功标识下单成功:true 下单失败 false
dataobject包含以下参数
orderIdstring订单 ID
localUserIdstring商户本地用户 ID
localOrderIdstring商户本地订单号
orderTypeenum订单类型PAYMENT:支付订单 WITHDRAW:提款订单
orderBizTypeenum订单业务类型orderBizType 类型说明如下
targetTypeenum目标类型targetType 类型说明如下
networkstring主网类型TRON
addressstring地址

orderBizType 类型说明:

1、PAYMENT_WALLET_SCAN Vpay钱包扫码支付
2、PAYMENT_TRANSFER 数字币绑定地址直充
3、PAYMENT_ANY_DIGITAL_SCAN 数字币任意金额扫码支付
4、WITHDRAW_WALLET 提款至Vpay钱包
5、WITHDRAW_ANY_DIGITAL_WALLET 提款数字币至任意钱包
6、PAYMENT_FIXED_DIGITAL_SCAN 数字币限定金额扫码支付
7、BATCH_PAY 批量代付

targetType 类型说明:

1、INTERNAL 内部地址
2、EXTERNAL 外部地址
3、USER 用户抽象地址

回调详情说明

回调的方式是:POST application/json
回调参数 json 化示例
{
"amount": 1,
"bizType": "WITHDRAW_ANY_DIGITAL_WALLET",
"currency": "USDT",
"extra": {
"quoteAmount": 10,
"quoteCurrency": "CNY",
"quotePrice": 10
},
"key": "h3cS7dBltRU4W1wD",
"localOrderId": "2820",
"merchantActualAmount": 22.72,
"merchantCurrency": "CNY",
"merchantId": 303122065665,
"merchantPaidAmount": 7.33,
"notifyTime": 1736744168370,
"orderCreateTime": 1731572133082,
"orderId": "273124814912907",
"sign": "699806308a9e055114c378671b0d2a15",
"status": "SUCCESS",
"type": "WITHDRAW",
"userAmount": 1,
"userCurrency": "USDT"
}
参数名称类型参与签名参数含义参数说明
amountdecimal订单金额
bizTypeenum订单类型bizType 类型说明如下
currencyString币种
keyString商户 key
localOrderIdString本地订单号
merchantActualAmountdecimal商户实际收款金额
merchantCurrencyString商户收款币种默认币种
merchantIdString商户号
merchantPaidAmountdecimal商户收款金额
merchantUserIdString用户 id
notifyTimelong回调时间
orderCreateTimelong订单创建时间
orderIdString订单号
statusString支付状态
typeString订单类型PAYMENT:支付 WITHDRAW:提款
userAmountdecimal用户付款金额
userCurrencyString用户支付币种
signStringmd5 签名详情看签名算法
extraobject包含一下参数
└quoteAmountnumber订单报价金额
└quoteCurrencynumber订单报价币种
└quotePricestring订单报价价格

bizType 类型说明:

1、PAYMENT_WALLET_SCAN Vpay钱包扫码支付
2、PAYMENT_TRANSFER 数字币绑定地址直充
3、PAYMENT_ANY_DIGITAL_SCAN 数字币任意金额扫码支付
4、WITHDRAW_WALLET 提款至Vpay钱包
5、WITHDRAW_ANY_DIGITAL_WALLET 提款数字币至任意钱包
6、PAYMENT_FIXED_DIGITAL_SCAN 数字币限定金额扫码支付
7、BATCH_PAY 批量代付

如果您接受到了回调信息,只需要返回success,即表示消息已处理,本条回调不再会发送,否则会尝试重复发送直到获得期望的响应, 目前的重试频率为15s, 15s, 30s, 180s, 600s, 1200s, 1800s,都无响应后,不再重复发送。